home *** CD-ROM | disk | FTP | other *** search
/ APDL Eductation Resources / APDL Eductation Resources.iso / programs / keyboard / drawstrip / !DrawStrip / ReadMe < prev   
Encoding:
Text File  |  1989-08-05  |  9.8 KB  |  205 lines
  1.                              DrawStrip
  2.  
  3.             A utility for preparing key strips as !Draw files
  4.  
  5.                           By C.T.Stretch
  6.  
  7. Files included :-
  8.  
  9.        Path       File      Type       Purpose
  10.  
  11.                   BasKeys   text       Example file with key definitions 
  12.                                        for the basic editor
  13.                   ReadMe    text       this file 
  14.        !DrawStrip.!RunImage BASIC      the main program
  15.        !DrawStrip.!Run      Obey       runs the program
  16.        !DrawStrip.!Sprites  sprite     one sprite
  17.  
  18.         
  19.   DrawStrip takes a text file that includes a list of text to put in each
  20. key position and produces a !Draw file keystrip that can be examined with
  21. !Draw or printed with  a RISC OS printer driver (!PrinterDM or !PrinterPS) .
  22.  
  23.   To try DrawStrip with the example text file BasKeys :-
  24.  
  25.   1) Load a printer driver and set it for your printer .
  26.   2) Ensure that the filer has seen !System , !Draw and !Fonts.
  27.      e.g. display a filer directory of the root directory of
  28.      Application disk 1
  29.   3) Check you have some font space configured .
  30.   4) Double click on the !DrawStrip icon , this should install DrawStrip on 
  31.      the iconbar .
  32.   5) Drag the BasKeys icon onto the DrawStrip icon on the iconbar .
  33.   6) After a few seconds a "Save as:" window should appear
  34.      either a) change the name if desired and drag to a filer window
  35.        or   b) click on <OK> to accept the path name as given 
  36.        or   c) drag onto a !Draw icon on the iconbar                  
  37.        or   d) drag into an open !Draw window
  38.        or   e) drag to the printer driver icon .
  39.     After a) or b)  you can drag the filer icon as c),d) or e) .
  40.                                                              
  41.  
  42.              Preparing a text file of key definitions
  43.  
  44.   These files can be prepared with !Edit . Examine BasKeys with !Edit as an
  45. example . Each line of the file starts with a keyword in lower case text
  46. followed by a number <n> or string <s> . The file must have type FFF (text).
  47.   Numbers are positive decimal integers . Strings are any printable
  48. characters up to the end of the line . 
  49.  
  50.   Keywords
  51.            rem <s>    ignored
  52.            row <n>    The following key definition apply to row n
  53.                       range 1 (bottom) - 8
  54.            f<n> <s>   sets the text for key n in the last chosen row to s
  55.                       range n  1 - 12
  56.                       s -  at most 80 chars (much fewer in practice)
  57.                       no space can precede the <n> 
  58.                       a space must follow the <n>
  59.            right <s>
  60.            left  <s>  sets the text to appear at the side of the boxes
  61.  
  62.   The remaining keywords should appear at most once each in a file . If two
  63. appear only the last is used . They need not appear at all , when the
  64. default is used .
  65.  
  66.            title <s>  sets the title of the strip to <s>
  67.            height <n> height of each box in 1/46080 inch 
  68.                       default 1/3 inch
  69.                       range 0 - 46080
  70.            tpoint <n> set the title text size to n points
  71.                       default 20
  72.                       range 2-40
  73.            kpoint <n>
  74.            spoint <n> set the maximum point size for the (k)ey or (s)ide text
  75.                       default 12
  76.                       range 2-40
  77.            tfont <s>
  78.            kfont <s>
  79.            sfont <s>  set the font for (t)itle,(k)eys or (s)ide
  80.                       default Trinity.Medium
  81.                       the fonts must reside in <Font$Path>
  82.            lwidth n   set the width of the lines in the boxes in 1/46080 inch
  83.                       default 320
  84.                       range 0 - 4608
  85.                       0 gives lines of minimum thickness
  86.  
  87.   The number of rows is taken from the largest row <n> in the file .
  88. So for example a file containing just "row 3" will produce an empty keystrip of 3 rows 1/3 inch high with line width 320/46080 inch .
  89.   Blank lines are permitted in a file . Any other lines not beginning with a keyword produce an error .
  90.   kpoint and spoint set a largest point size , Drawstrip steps down the
  91. pointsize by twos until the text will fit in the avaliable space . If you
  92. use a large kpoint a large variety of text sizes will appear that looks
  93. rather untidy , although some keys will be easier to read .
  94.  
  95.                      Errors and difficulties
  96.  
  97.   System resources cannot be found
  98.            the filer has not seen !System
  99.                 - [ cancel ] then open a directory containing !System
  100.   Fonts  cannot be found
  101.            the filer has not seen !Fonts
  102.                 - [ cancel ] then open a directory containing !Fonts
  103.   Bad text error - followed by line
  104.            your text input file is incorrect at this line
  105.                  -  [ OK ]   ignore line and continue
  106.                  -  [ cancel ]  abandon attempt
  107.   Printer driver needed .....
  108.            DrawStrip reads the papersize from the printer module
  109.                  -  [ cancel ] then load a printer driver and try again 
  110.   The strip is truncated at the end(s)                               
  111.            Your paper is too short 
  112.                  - use only 'right' or 'left' not both or
  113.                    load into draw , copy and move one up and one down 
  114.                    then print and glue the truncated pieces together
  115.            Your printer driver has large margins 
  116.                  - see printer drivers below
  117.   The text appears 'hairy'
  118.            your printer driver has too large a block for anti-aliasing
  119.                  - see printer drivers below
  120.   The program takes a long time and many disk accesses
  121.            you have not configured enough fontsize
  122.                  - see Fontsize below
  123.                   
  124.  
  125.                               Resources
  126.  
  127.   Using the program will need
  128.      !DrawStrip , !Draw , !Edit to produce input 
  129.      !System to define <Wimp$Scrap> for the direct transfer system
  130.      !Fonts to set <Font$Prefix> and provide the fonts
  131.      !PrinterDM or other driver
  132.   If you have a single floppy you could copy these onto one disk and save a
  133. lot of disk swapping
  134.      
  135.  
  136.                               Fontsize
  137.  
  138.   If you normally have the machine configured with no or little fontsize you
  139. may wish the !Run file to allocate it for you . Examine !Run and remove the
  140. comment bars ' | ' from the two lines . You will need to copy the MemAlloc
  141. module into !System.Modules . It can be found in !Lander on Application disk
  142. 2 .
  143.  
  144.                            Printer Drivers
  145.  
  146.   The quality of the output from DrawStrip or other !Draw files depends on
  147. having your printer driver set up correctly . Presumably if you have a laser
  148. printer this should not be a problem , although you may still have to set up
  149. the margins . The following may help if you are using PrinterDM .
  150.   My printer is an ancient MX80III . The only resolution supplied by
  151. PrinterDM that it supported was 60x72 dpi which is useless for Draw files .
  152. The printer also supports 120x72 and 120x216 and it turned out to be quite
  153. easy to set the printer driver to these . The following observations are
  154. purely experimental but should not do too much harm .
  155.   If you look in the directory !PrinterDM you will find a text file PrData .
  156. Make sure you have another copy of this and then load it into !Edit . It
  157. consists of three parts 
  158.      Defaults : this sets the values for certain variables if they are not
  159. changed in the next part
  160.      Real printer definitions : this sets the values for a list of printers
  161.      Configured options : stores your configured options       
  162.   To set up a new real printer definition make a copy of the nearest one to
  163. it at the end of the list and change the name and the number to the next
  164. unused number , then change or add variable definitions . Most of the
  165. variable names are obvious .
  166.   The pxres_halftone and pyres_halftone variables set the size of a box that
  167. is partially filled to simulate different shades . If this is too big
  168. anti-aliased fonts give rise to 'hairy' letters , as the shading pixels may
  169. not be on the right side of the box . Try using pxres and pyres / 1 or 2 . (Putting both to /1 seems not to work?) 
  170.   The paper size and margins are set in the defaults , but there is nothing
  171. to stop you changing them in your definition . If you are using fanfold
  172. paper you can set page_bottom to 0 , page_top to 841920 , then a DrawStrip
  173. strip will fit completely on A4 paper . You should probably not set
  174. page_right to more than 576000 on a 8inch carriage printer . The margins are
  175. read by !Draw and used to set up the grey areas that appear when you do
  176. 'show paper limits' if you have a printer driver loaded .
  177.   Of course you can keep other printer definitions for your printer in the
  178. same file with different settings . It may be worth deleting printer
  179. definitions that you will never use as it may speed up the loading of
  180. PrinterDM . Check that the printer in configured options is set to a number
  181. that still exists .
  182.  
  183.                             Philosophy
  184.  
  185.   This program started as a small exercise to write a !Draw file that did
  186. something (slightly) useful . It just grew in the way wimp programs seem to
  187. .
  188.   Acorn has produced an excellent idea in the PrinterDriver system . It
  189. means authors can write graphical output for their printer safe(?) in the
  190. knowledge that it will produce output on the lowest dot-matrix printer , the
  191. most superior Postscript laser and even(?) a plotter . Writing output
  192. directly to the printer driver looks like hard work , and for most purposes
  193. producing a !Draw file should be easier , and has other advantages such as
  194. allowing the user to review or alter the work before printing .
  195.  So , why not write your programs to produce output as !Draw files , and
  196. distribute any documents that need graphics as !Draw files
  197.  
  198.                                Contacts
  199.  
  200.   Any comments , bug reports etc. gratefully received by
  201.               Chris Stretch    on
  202.                                    Archive BBS No 62
  203.                                or  JANET CBTP13@UK.AC.ULSTER
  204.  
  205.